Skip to main content

​
XGameSaveCreateContainer

Crea un identificador de XGameSaveContainer.

​
Sintaxis

​
Parámetros

provider   _In_
Tipo: XGameSaveProviderHandle Identificador del XGameSaveProvider que creará el contenedor. containerName   _In_z_
Tipo: char* Nombre del contenedor que se va a crear. Los caracteres válidos para la parte de la ruta de acceso del nombre del contenedor (hasta la última barra diagonal, incluida) incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), guion bajo (_) y barra diagonal (/). La parte de la ruta de acceso puede estar vacía. Los caracteres válidos para la parte del nombre de archivo (todo lo que sigue a la última barra diagonal) incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), guion bajo (_), punto (.) y guion (-). El nombre de archivo no puede estar vacío, terminar en un punto ni contener dos puntos consecutivos. La longitud máxima del nombre del contenedor es de 256 caracteres. containerContext   _Outptr_result_nullonfailure_
Tipo: XGameSaveContainerHandle* Identificador del XGameSaveContainer que devolverá esta llamada de función.

​
Valor devuelto

Tipo: HRESULT Resultado de la función. Si containerName no es válido, la función devolverá E_GS_INVALID_CONTAINER_NAME (0x80830001).

​
Comentarios

No es seguro llamar a esta función en un subproceso con dependencia temporal. Para obtener más información, consulte Subprocesos con dependencia temporal.
La API XGameSave requiere que el título tenga su identificador de título y su identificador de configuración de servicio (SCID)
configurados correctamente para funcionar. Para obtener más información sobre estos identificadores necesarios, consulte Configuración de sandboxes para el desarrollo de XBOX Live. Su juego debe estar habilitado para XBOX Live en Partner Center. Si no configura correctamente el SCID y el identificador de título, las llamadas a la API XSaveGame fallarán con el siguiente código de error: E_GS_NO_ACCESS - 0x80830002 - La operación falló porque el título no tiene acceso a los espacios de almacenamiento de contenedores. XGameSaveCreateContainer se usa tanto para crear un nuevo contenedor como para acceder a un contenedor creado anteriormente usando el nombre como identificador. Un contenedor de partidas guardadas contiene información sobre un jugador en forma de XGameSaveBlobs. Los blobs son datos específicos asociados a un jugador; esos datos incluyen un nombre y un valor junto con otra información que ayuda a leer los datos del blob. Puede encontrar la composición de un XGameSaveContainer en la estructura XGameSaveContainerInfo.
Un contenedor no se finaliza hasta que se haya llamado a XGameSaveSubmitUpdate o XGameSaveSubmitUpdateAsync para el contenedor. Hasta que se haya llamado a la API de actualización, el contenedor no aparecerá en los resultados de XGameSaveEnumerateContainerInfoByName.

​
Requisitos

Encabezado: XGameSave.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

​
Documentación conceptual

​
Consulte también

XGameSave
XGameSaveContainerInfo
XGameSaveBlob
Depuración de partidas guardadas
Última modificación el 28 de agosto de 2026

Temas relacionados

XGameSaveCloseContainerXGameSaveGetContainerInfoInformación general de la API XGameSaveXGameSaveContenedores de API de C# de Unity para el GDK