XPersistentLocalStoragePromptUserForSpaceAsync
타이틀이 Growable 영구 로컬 저장소의 필요한 총 바이트 수를 해제하라는 메시지를 사용자에게 전송하게 할 수 있습니다.
구문
HRESULT XPersistentLocalStoragePromptUserForSpaceAsync(
uint64_t requestedBytes,
XAsyncBlock* asyncBlock
)
매개 변수
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 콘솔