Skip to main content

​
XPersistentLocalStoragePromptUserForSpaceAsync

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

​
구문

​
매개 변수

requestedBytes   _In_
형식: uint64_t 타이틀이 사용할 수 있게 되기를 원하는 총 공간 크기입니다. asyncBlock   _Inout_
형식: XAsyncBlock* 비동기 호출의 상태를 모니터링하기 위한 XAsyncBlock입니다.

​
반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.

​
설명

호출 전에 타이틀은 XPersistentLocalStorageGetSpaceInfo를 사용하여 여유 공간 가용성을 확인해야 합니다. 요청 결과는 XPersistentLocalStoragePromptUserForSpaceResult를 호출하여 콜백 함수 내에서 확인해야 합니다. 이는 사용자가 요청된 바이트 수를 해제했다고 보장하는 것은 아니며, 사용자가 조치를 취했다는 것만 나타냅니다. 사용자가 공간 요청을 초래한 작업을 다시 시도하면 게임은 XPersistentLocalStorageGetSpaceInfo를 사용하여 여유 공간을 다시 쿼리해야 합니다. 사용자가 공간을 확보하지 않기로 선택한 경우 비동기 작업의 결과는 E_ABORT입니다. 영구 로컬 스토리지는 PC 플랫폼에는 구현되어 있지 않습니다. 존재하기는 하지만, 이 메서드는 PC에서 사용하면 안 됩니다. 이는 데이터센터 스트리밍 서버에서는 사용할 수 없습니다. 데이터센터 스트리밍 서버에서 호출하면 항상 E_ABORT를 반환합니다.

​
요구 사항

헤더: XPersistentLocalStorage.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

​
개념 문서

​
함께 보기

XPersistentLocalStorage
마지막 수정일 2026년 8월 24일

관련 항목

XPersistentLocalStoragePromptUserForSpaceResultXPersistentLocalStorageSpaceInfoXPersistentLocalStorageGDK용 Unity C# API 래퍼XPersistentLocalStorageGetSpaceInfo