Skip to main content

XGameSaveCreateContainer

创建 XGameSaveContainer 句柄。

Syntax

Parameters

provider   _In_
类型:XGameSaveProviderHandle
将创建容器的 XGameSaveProvider 的句柄。 containerName   _In_z_
类型:char*
要创建的容器的名称。 容器名称的路径部分(一直到并包括最后一个正斜杠)的有效字符包括大写字母 (A-Z)、小写字母 (a-z)、数字 (0-9)、下划线 (_) 和正斜杠 (/)。路径部分可以为空。 文件名部分(最后一个正斜杠之后的所有内容)的有效字符包括大写字母 (A-Z)、小写字母 (a-z)、数字 (0-9)、下划线 (_)、句点 (.) 和连字符 (-)。文件名不能为空、不能以句点结尾,也不能包含两个连续的句点。 容器名称的最大长度为 256 个字符。 containerContext   _Outptr_result_nullonfailure_
类型:XGameSaveContainerHandle*
此函数调用将返回的 XGameSaveContainer 的句柄。

Return value

类型:HRESULT 函数结果。如果 containerName 无效,函数将返回 E_GS_INVALID_CONTAINER_NAME (0x80830001)。

Remarks

此函数在时间敏感型线程上调用是不安全的。有关详细信息,请参阅时间敏感型线程
XGameSave API 要求你的标题正确配置其标题 ID 和服务配置 ID (SCID) 才能工作。
有关这些必需 ID 的详细信息,请参阅为 XBOX Live 开发设置沙盒。你的游戏必须在合作伙伴中心中启用 XBOX Live。
如果没有正确配置 SCID 和标题 ID,XSaveGame API 调用将失败,并返回以下错误代码: E_GS_NO_ACCESS - 0x80830002 - 因为标题无权访问容器存储空间,所以操作失败。 XGameSaveCreateContainer 既可以用于创建新容器,也可以使用名称作为标识符访问以前创建的容器。游戏保存容器以 XGameSaveBlob 的形式保存有关玩家的信息。Blob 是与玩家关联的特定数据,该数据包括名称和值以及其他有助于读取 Blob 数据的信息。你可以在 XGameSaveContainerInfo 结构中找到 XGameSaveContainer 的组成。
只有为容器调用了 XGameSaveSubmitUpdateXGameSaveSubmitUpdateAsync 之后,容器才会最终确定。在调用更新 API 之前,该容器不会出现在 XGameSaveEnumerateContainerInfoByName 的结果中。

Requirements

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

Conceptual documentation

See also

XGameSave
XGameSaveContainerInfo
XGameSaveBlob
调试游戏保存
最后修改于 2026年8月24日