> ## 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](/zh-TW/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 主機

## 概念文件

* [遊戲存檔儲存系統](/zh-TW/build/core-features/common/game-save/game-saves-storage-systems)
* [XGameSave API 概觀](/zh-TW/build/core-features/common/game-save/xgamesave)
* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members)\
[XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveGetRemainingQuota](/reference/system/xgamesave/functions/xgamesavegetremainingquota.md)
- [Game Saves storage systems](/build/core-features/common/game-save/game-saves-storage-systems.md)
- [XGameSave API overview](/build/core-features/common/game-save/xgamesave.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)
- [XGameSave API 개요](/ko/build/core-features/common/game-save/xgamesave.md)