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) 才能工作。
只有为容器调用了 XGameSaveSubmitUpdate 或 XGameSaveSubmitUpdateAsync 之后,容器才会最终确定。在调用更新 API 之前,该容器不会出现在 XGameSaveEnumerateContainerInfoByName 的结果中。
Requirements
头文件: XGameSave.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机Conceptual documentation
See also
XGameSaveXGameSaveContainerInfo
XGameSaveBlob
调试游戏保存
