Skip to main content

​
XSystemGetXboxLiveSandboxId

Recupera el identificador de sandbox de XBOX Live.

​
Sintaxis

​
Parámetros

sandboxIdSize _In_
Tipo: size_t El tamaño de sandboxId, en bytes. Este valor debe ser igual o mayor que la constante XSystemXboxLiveSandboxIdMaxBytes definida en XSystem.h. sandboxId _Out_writes_bytes_to_(sandboxIdSize,*sandboxIdUsed)
Tipo: char* El búfer de caracteres que recibirá el identificador de sandbox. sandboxIdUsed _Out_opt_
Tipo: size_t* El tamaño real, en bytes, del búfer sandboxId devuelto.

​
Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte Códigos de error. Si la función falla porque sandboxIdSize está establecido en un valor menor que XSystemXboxLiveSandboxIdMaxBytes, el valor devuelto se establece en HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).

​
Comentarios

Junto con el TitleID y el identificador de configuración de servicio (SCID), el identificador de sandbox es fundamental para el desarrollo de títulos y aplicaciones de XBOX Live. El identificador de sandbox identifica su sandbox, que proporciona aislamiento de contenido para su kit de desarrollo durante el desarrollo. El aislamiento de contenido garantiza que tenga un entorno limpio para desarrollar y probar su título.
Los identificadores de sandbox distinguen mayúsculas de minúsculas.
Para los dispositivos XBOX y PC, el identificador de sandbox se almacena en el dispositivo. Si no se encuentra el identificador de sandbox, o si no tiene permisos para acceder a él, el identificador de sandbox tiene como valor predeterminado ‘RETAIL’. Esta función también devolverá ‘RETAIL’ si, de hecho, su juego se está ejecutando en el entorno comercial.

​
Requisitos

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

​
Documentación conceptual

​
Consulte también

Configuración de las opciones del kit de desarrollo (tema con NDA)
Configuración de sandboxes para el desarrollo de XBOX Live
XSystemGetConsoleId
XSystem
Última modificación el 28 de agosto de 2026

Temas relacionados

Determinación de la ubicación de la consolaXSystemXGameGetXboxTitleIdSandboxesPFAccountManagementGetPlayFabIDsFromXboxLiveIDsRequest