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

# XGameSaveGetRemainingQuota

> XGameSaveGetRemainingQuota

# XGameSaveGetRemainingQuota

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

## 구문

```cpp theme={null}
HRESULT XGameSaveGetRemainingQuota(  
         XGameSaveProviderHandle provider,  
         int64_t* remainingQuota  
)  
```

### 매개 변수

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

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

*remainingQuota*   \_Out\_\
형식: int64\_t\*

저장소로 사용할 수 있는 데이터의 양입니다.

### 반환값

형식: HRESULT

함수 결과입니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출해도 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

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

```cpp theme={null}
void Sample::_GetQuotaSync(uint64_t* remainingQuota) 
{ 
    HRESULT hr = XGameSaveGetRemainingQuota(_provider, remainingQuota); 
    if (FAILED(hr)) 
    { 
        printf("Error retrieving Quota hr=0x%08x\n", hr); 
    } 
} 
```

## 요구 사항

**헤더:** XGameSave.h

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

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

## 개념 설명서

* [게임 저장 저장소 시스템](/build/core-features/common/game-save/game-saves-storage-systems)
* [XGameSave API 개요](/build/core-features/common/game-save/xgamesave)
* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

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


## Related topics

- [XGameSave API 개요](/ko/build/core-features/common/game-save/xgamesave.md)
- [XGameSave](/ko/reference/system/xgamesave/xgamesave_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameSaveGetRemainingQuotaAsync](/ko/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md)
- [XGameSaveGetRemainingQuotaResult](/ko/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)