> ## 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\*](/zh-TW/reference/system/xasync/structs/xasyncblock)

包含呼叫內容和回呼函式的 AsyncBlock。

### 傳回值

類型：HRESULT

函式結果。

## 備註

結果和剩餘配額可從 [XGameSaveGetRemainingQuotaResult](/zh-TW/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) 函式擷取。

每個應用程式都有可為使用者儲存多少資料的配額，如果超過配額，任何儲存更多資料的嘗試都可能會失敗並傳回 **E\_GS\_QUOTA\_EXCEEDED**。由於這不是固定大小，我們公開了剩餘配額的存取權，讓應用程式可以嘗試避免 **E\_GS\_QUOTA\_EXCEEDED** 失敗。為了提供準確的檢視，我們一律會確保在傳回之前先處理任何未完成的寫入、更新或刪除，因為這些作業都可能變更剩餘配額。

## 需求

**標頭：** XGameSave.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [非同步程式設計模型](/zh-TW/build/core-features/common/async/async-programming-model)

## 另請參閱

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


## Related topics

- [XGameSaveGetRemainingQuotaResult](/zh-TW/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)
- [非同步程式設計模型](/zh-TW/build/core-features/common/async/async-programming-model.md)
- [XAsyncGetResultSize](/zh-TW/reference/system/xasync/functions/xasyncgetresultsize.md)
- [XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members.md)
- [適用於 GDK 的 Unity C# API 包裝函式](/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)