> ## 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](/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo) 구조체를 반환합니다.

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*info*   \_Out\_\
형식: [XPersistentLocalStorageSpaceInfo\*](/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**를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

<a id="remarksSection" />

## 설명

타이틀에서 확장 가능한 영구 로컬 스토리지(GPLS)를 사용하는 경우 이 함수를 사용하여 사용 가능한 스토리지 공간을 확인합니다.

스토리지 세부 정보는 [XPersistentLocalStorageSpaceInfo](/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo) 구조체에 포함되어 있습니다.

스토리지 세부 정보에는 사용 중인 공간, 타이틀에서 사용할 수 있는 공간, 사용자에게 공간을 확보하도록 요청해야 하는지 여부가 포함됩니다.

[GetDiskFreeSpaceExW](https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-getdiskfreespaceexw)를 호출하면 PLS에 남아 있는 최대 여유 공간만 타이틀에 알려주며, 이는 사용 가능하다고 보장되지 않습니다.
[XPersistentLocalStorageGetSpaceInfo](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo)는 사용 가능한 총 여유 공간뿐만 아니라 실제로 사용할 수 있는 여유 공간(여유 공간과 기본 드라이브의 실제 공간 중 최솟값)도 반환합니다.

<a id="requirementsSection" />

## 요구 사항

**헤더:** XPersistentLocalStorage.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 개념 문서

* [XBOX 콘솔의 로컬 스토리지](/build/console-features/storage/local-storage)

## 함께 보기

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


## Related topics

- [XPersistentLocalStorageSpaceInfo](/ko/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStorage](/ko/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](/ko/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](/ko/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)