Skip to main content

XGameSaveGetRemainingQuota

XGameSave API를 사용하여 저장할 수 있는 데이터의 양을 반환합니다.

구문

매개 변수

provider   _In_
형식: XGameSaveProviderHandle
남은 데이터를 쿼리할 XGameSaveProvider 에 대한 핸들입니다. remainingQuota   _Out_
형식: int64_t*
저장소로 사용할 수 있는 데이터의 양입니다.

반환값

형식: HRESULT 함수 결과입니다.

설명

이 함수는 시간에 민감한 스레드에서 호출해도 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
각 애플리케이션에는 사용자에 대해 저장할 수 있는 데이터의 양에 대한 할당량이 있습니다. 이를 초과하면 더 많은 데이터를 저장하려는 시도는 E_GS_QUOTA_EXCEEDED 로 실패할 수 있습니다. 이는 고정된 크기가 아니므로 애플리케이션이 E_GS_QUOTA_EXCEEDED 실패를 피할 수 있도록 남은 할당량에 대한 액세스를 제공했습니다. 정확한 상태를 표시하기 위해, 남은 할당량을 변경할 수 있는 쓰기, 업데이트, 삭제가 완료된 이후 반환하도록 항상 처리합니다. XGameSaveSubmitUpdate 호출을 실행하기에 적절한 양의 데이터가 남아 있는지 확인하려면 이 함수를 호출하는 것이 좋습니다.

요구 사항

헤더: XGameSave.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 설명서

함께 보기

XGameSave
XGameSaveSubmitUpdate
게임 저장 디버깅
마지막 수정일 2026년 8월 24일