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

# XPersistentLocalStoragePromptUserForSpaceAsync

> XPersistentLocalStoragePromptUserForSpaceAsync

# XPersistentLocalStoragePromptUserForSpaceAsync

타이틀이 요청된 총 바이트 수의 확장 가능한 영구 로컬 스토리지를 확보하도록 사용자에게 메시지를 표시할 수 있게 합니다.

## 구문

```cpp theme={null}
HRESULT XPersistentLocalStoragePromptUserForSpaceAsync(  
         uint64_t requestedBytes,  
         XAsyncBlock* asyncBlock  
)  
```

### 매개 변수

*requestedBytes*   \_In\_\
형식: uint64\_t

타이틀이 사용할 수 있게 되기를 원하는 총 공간 크기입니다.

*asyncBlock*   \_Inout\_\
형식: XAsyncBlock\*

비동기 호출의 상태를 모니터링하기 위한 XAsyncBlock입니다.

### 반환 값

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

성공하면 **S\_OK**를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

## 설명

호출 전에 타이틀은 [XPersistentLocalStorageGetSpaceInfo](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo)를 사용하여 여유 공간 가용성을 확인해야 합니다.

요청 결과는 [XPersistentLocalStoragePromptUserForSpaceResult](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult)를 호출하여 콜백 함수 내에서 확인해야 합니다. 이는 사용자가 요청된 바이트 수를 해제했다고 보장하는 것은 아니며, 사용자가 조치를 취했다는 것만 나타냅니다. 사용자가 공간 요청을 초래한 작업을 다시 시도하면 게임은 [XPersistentLocalStorageGetSpaceInfo](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo)를 사용하여 여유 공간을 다시 쿼리해야 합니다. 사용자가 공간을 확보하지 않기로 선택한 경우 비동기 작업의 결과는 E\_ABORT입니다.

영구 로컬 스토리지는 PC 플랫폼에는 구현되어 있지 않습니다. 존재하기는 하지만, 이 메서드는 PC에서 사용하면 안 됩니다.

이는 데이터센터 스트리밍 서버에서는 사용할 수 없습니다. 데이터센터 스트리밍 서버에서 호출하면 항상 E\_ABORT를 반환합니다.

## 요구 사항

**헤더:** XPersistentLocalStorage.h

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

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

## 개념 문서

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

## 함께 보기

[XPersistentLocalStorage](/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)


## Related topics

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