> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSystemGetXboxLiveSandboxId

> XSystemGetXboxLiveSandboxId

# XSystemGetXboxLiveSandboxId

Recupera el identificador de sandbox de XBOX Live.

## Sintaxis

```cpp theme={null}
HRESULT XSystemGetXboxLiveSandboxId(  
         size_t sandboxIdSize,  
         char* sandboxId,  
         size_t* sandboxIdUsed  
)  
```

### Parámetros

*sandboxIdSize*   \_In\_<br />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)<br />Tipo: char\*

El búfer de caracteres que recibirá el identificador de sandbox.

*sandboxIdUsed*   \_Out\_opt\_<br />Tipo: size\_t\*

El tamaño real, en bytes, del búfer *sandboxId* devuelto.

### Valor devuelto

Tipo: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

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](/reference/errorcodes). 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.

<Note>
  Los identificadores de sandbox distinguen mayúsculas de minúsculas.
</Note>

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

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[Configuración de las opciones del kit de desarrollo (tema con NDA)](/home/setup-install/dev-kit-settings/config-dev-kit-settings)<br />[Configuración de sandboxes para el desarrollo de XBOX Live](/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes)<br />[XSystemGetConsoleId](/reference/system/xsystem/functions/xsystemgetconsoleid)<br />[XSystem](/reference/system/xsystem/xsystem_members)


## Related topics

- [Determinación de la ubicación de la consola](/es/build/game-principles/localization/determining-console-geolocation.md)
- [XSystem](/es/reference/system/xsystem/xsystem_members.md)
- [XGameGetXboxTitleId](/es/reference/system/xgame/functions/xgamegetxboxtitleid.md)
- [Sandboxes](/es/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [PFAccountManagementGetPlayFabIDsFromXboxLiveIDsRequest](/es/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementgetplayfabidsfromxboxliveidsrequest.md)