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

# XGameSaveGetRemainingQuotaAsync

> XGameSaveGetRemainingQuotaAsync

# XGameSaveGetRemainingQuotaAsync

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

## 구문

```cpp theme={null}
HRESULT XGameSaveGetRemainingQuotaAsync(  
         XGameSaveProviderHandle provider,  
         XAsyncBlock* async  
)  
```

### 매개 변수

*provider*   \_In\_\
형식: XGameSaveProviderHandle

남은 데이터를 쿼리할 XGameSaveProvider에 대한 핸들입니다.

*async*   \_In\_\
형식: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

호출 컨텍스트와 콜백 함수를 포함하는 AsyncBlock입니다.

### 반환값

형식: HRESULT

함수 결과입니다.

## 설명

결과 및 남은 할당량은 [XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) 함수에서 검색됩니다.

각 애플리케이션에는 사용자에 대해 저장할 수 있는 데이터의 양에 대한 할당량이 있습니다. 이를 초과하면 더 많은 데이터를 저장하려는 시도는 **E\_GS\_QUOTA\_EXCEEDED** 로 실패할 수 있습니다. 이는 고정된 크기가 아니므로 애플리케이션이 **E\_GS\_QUOTA\_EXCEEDED** 실패를 피할 수 있도록 남은 할당량에 대한 액세스를 제공했습니다. 정확한 상태를 표시하기 위해, 남은 할당량을 변경할 수 있는 쓰기, 업데이트, 삭제가 완료된 이후 반환하도록 항상 처리합니다.

## 요구 사항

**헤더:** XGameSave.h

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

**지원되는 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [비동기 프로그래밍 모델](/build/core-features/common/async/async-programming-model)

## 함께 보기

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult)\
[게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveGetRemainingQuotaResult](/ko/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)
- [비동기 프로그래밍 모델](/ko/build/core-features/common/async/async-programming-model.md)
- [XAsyncGetResultSize](/ko/reference/system/xasync/functions/xasyncgetresultsize.md)
- [XGameSave](/ko/reference/system/xgamesave/xgamesave_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)