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

## Syntax

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

### Parameters

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

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

*remainingQuota*   \_Out\_\
类型：int64\_t\*

可用作存储的数据量。

### Return value

类型：HRESULT

函数结果。

## Remarks

<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); 
    } 
} 
```

## Requirements

**头文件：** XGameSave.h

**库：** xgameruntime.lib

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

## Conceptual documentation

* [游戏保存存储系统](/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)

## See also

[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 概述](/zh-CN/build/core-features/common/game-save/xgamesave.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)
- [XGameSaveGetRemainingQuotaAsync](/zh-CN/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md)
- [XGameSaveGetRemainingQuotaResult](/zh-CN/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)