Skip to main content

​
XGameSaveSubmitBlobDelete

将删除操作添加到游戏保存 XGameSaveUpdate。

​
语法

​
参数

updateContext   _In_
类型：XGameSaveUpdateHandle 将删除 Blob 的 XGameSaveUpdate 的句柄。 blobName   _In_z_
类型：char* 要删除的 Blob 的名称。

​
返回值

类型：HRESULT 函数结果

​
备注

在时间敏感线程上调用此函数并不安全。有关详细信息，请参阅时间敏感线程。
在进行此调用之前，你需要成功调用 XGameSaveCreateUpdate。 此 API 的存储部分旨在以安全、可靠和事务性方式将数据从游戏轻松传输到持久化存储。我们希望确保容器的支持数据始终一致，因此我们希望整个操作原子性地成功或失败。我们不希望出现部分更新的情况，即某些 Blob 数据与容器中的其他数据不一致。为此，我们提供了一个更新上下文，可以向其提交 Blob 写入和删除操作，一旦准备就绪，就会提交整个上下文。实际上，这看起来如下所示： XGameSaveUpdate 将通过 XGameSaveSubmitBlobWrite 和 XGameSaveSubmitBlobDelete 填充要在容器内的 Blob 上执行的写入和删除操作。通过调用 XGameSaveSubmitUpdate 完成更新。 有关用法，请参阅 XGameSaveCreateUpdate 示例。

​
要求

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

​
概念性文档

​
另请参阅

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitUpdate
XGameSaveSubmitBlobWrite
调试游戏保存
最后修改于 2026年8月24日

相关主题

XGameSaveSubmitBlobWriteXGameSaveSubmitUpdateXGameSaveSubmitUpdateAsyncXGameSaveCreateUpdateXGameSave