XPersistentLocalStoragePromptUserForSpaceAsync
允许游戏提示用户释放请求的可增长持久本地存储总字节数。
语法
HRESULT XPersistentLocalStoragePromptUserForSpaceAsync(
uint64_t requestedBytes,
XAsyncBlock* asyncBlock
)
参数
requestedBytes _In_
类型:uint64_t
游戏希望可供使用的空间总量。
asyncBlock _Inout_
类型:XAsyncBlock*
用于监视异步调用的状态的 XAsyncBlock。
返回值
类型:HRESULT
如果成功,则返回 S_OK;否则返回错误代码。 有关错误代码的列表,请参阅错误代码。
备注
游戏应先使用 XPersistentLocalStorageGetSpaceInfo 查看可用空间的可用性,再进行调用。
应在回调函数中通过调用 XPersistentLocalStoragePromptUserForSpaceResult 来检查请求的结果。 这并不能保证用户释放了请求的字节数;只能保证用户采取了行动。 当用户重试导致空间请求的操作时,游戏应使用 XPersistentLocalStorageGetSpaceInfo 再次查询可用空间。 如果用户选择不释放空间,则异步操作的结果为 E_ABORT。
电脑平台上未实现持久本地存储。 虽然存在此方法,但不应在电脑上使用。
在数据中心流式处理服务器上禁用此项。 在数据中心流式处理服务器上调用时,它将始终返回 E_ABORT。
要求
头文件:XPersistentLocalStorage.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机