XGameSaveSubmitBlobDelete

向游戏保存 XGameSaveUpdate 添加一个删除操作。

语法

HRESULT XGameSaveSubmitBlobDelete(  
         XGameSaveUpdateHandle updateContext,  
         const char* blobName  
)  

参数

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
游戏保存错误