> ## 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 存储的可用数据量。

## Syntax

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

### Parameters

*provider*   \_In\_\
类型：XGameSaveProviderHandle

要查询剩余数据的 XGameSaveProvider 的句柄。

*async*   \_In\_\
类型：[XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

包含调用上下文和回调函数的 AsyncBlock。

### Return value

类型：HRESULT

函数结果。

## Remarks

从 [XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) 函数中检索结果和剩余配额。

每个应用程序对可为一个用户保存的数据量都有配额，如果超过此配额，任何保存更多数据的尝试都可能失败并返回 **E\_GS\_QUOTA\_EXCEEDED**。由于这不是一个固定大小，因此我们公开了对剩余配额的访问权限，以便应用程序可以尝试避免 **E\_GS\_QUOTA\_EXCEEDED** 失败。为了提供准确的视图，我们始终确保在返回之前先处理任何未完成的写入、更新或删除操作，因为其中任何一项都可能更改剩余配额。

## Requirements

**头文件：** XGameSave.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## Conceptual documentation

* [异步编程模型](/build/core-features/common/async/async-programming-model)

## See also

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult)\
[调试游戏保存](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveGetRemainingQuotaResult](/zh-CN/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)
- [异步编程模型](/zh-CN/build/core-features/common/async/async-programming-model.md)
- [XAsyncGetResultSize](/zh-CN/reference/system/xasync/functions/xasyncgetresultsize.md)
- [XGameSave](/zh-CN/reference/system/xgamesave/xgamesave_members.md)
- [面向 GDK 的 Unity C# API 包装器](/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)