Skip to main content

​
XPersistentLocalStoragePromptUserForSpaceAsync

允许游戏提示用户释放所请求的可扩展永久本地存储总字节数。

​
语法

​
参数

requestedBytes   _In_
类型：uint64_t 游戏希望可供使用的空间总量。 asyncBlock   _Inout_
类型：XAsyncBlock* 用于监视异步调用状态的 XAsyncBlock。

​
返回值

类型：HRESULT 如果成功，则返回 S_OK；否则返回错误代码。有关错误代码列表，请参阅错误代码。

​
备注

在调用之前，游戏应使用 XPersistentLocalStorageGetSpaceInfo 检查可用空间。 应在回调函数中通过调用 XPersistentLocalStoragePromptUserForSpaceResult 来检查请求结果。这并不保证用户释放了所请求的字节数；仅表示用户执行了操作。当用户重试导致空间请求的操作时，你的游戏应再次使用 XPersistentLocalStorageGetSpaceInfo 查询可用空间。如果用户选择不释放空间，则异步操作的结果为 E_ABORT。 永久本地存储未在 PC 平台上实现。虽然该方法存在，但不应在 PC 上使用。 此功能在数据中心流式传输服务器上处于禁用状态。在数据中心流式传输服务器上调用时，它始终返回 E_ABORT。

​
要求

头文件： XPersistentLocalStorage.h 库： xgameruntime.lib 支持的平台： Windows、XBOX One 系列主机和 XBOX Series 主机

​
概念文档

​
另请参阅

XPersistentLocalStorage
最后修改于 2026年8月24日

相关主题

XPersistentLocalStoragePromptUserForSpaceResultXPersistentLocalStorageSpaceInfoXPersistentLocalStorage面向 GDK 的 Unity C# API 包装器XPersistentLocalStorageGetSpaceInfo