> ## 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 a ID da área restrita do XBOX Live.

## Sintaxe

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

### Parâmetros

*sandboxIdSize*   \_In\_<br />Tipo: size\_t

O tamanho de *sandboxId*, em bytes. Esse valor deve ser igual ou maior que a constante **XSystemXboxLiveSandboxIdMaxBytes** definida em XSystem.h.

*sandboxId*   \_Out\_writes\_bytes\_to\_(sandboxIdSize,\*sandboxIdUsed)<br />Tipo: char\*

O buffer de caracteres que receberá a ID da área restrita.

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

O tamanho real, em bytes, do buffer *sandboxId* retornado.

### Valor retornado

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

Retornará **S\_OK** se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes). Se a função falhar porque *sandboxIdSize* está definido com um valor menor que **XSystemXboxLiveSandboxIdMaxBytes**, o valor retornado será definido como **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)**.

## Comentários

Junto com a TitleID e a SCID (ID de Configuração do Serviço), a ID da área restrita é essencial para o desenvolvimento de títulos e aplicativos do XBOX Live. A ID da área restrita identifica sua área restrita, que fornece isolamento de conteúdo para seu kit de desenvolvimento durante o desenvolvimento. O isolamento de conteúdo garante que você tenha um ambiente limpo para desenvolver e testar seu título.

<Note>
  As IDs de área restrita diferenciam maiúsculas de minúsculas.
</Note>

Para dispositivos XBOX e PC, a ID da área restrita é armazenada no dispositivo. Se a ID da área restrita não for encontrada ou se você não tiver permissões para acessá-la, a ID da área restrita usará como padrão 'RETAIL'.

Esta função também retornará 'RETAIL' se seu jogo estiver de fato em execução no ambiente de varejo.

## Requisitos

**Cabeçalho:** XSystem.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[Definindo as configurações do kit de desenvolvimento (tópico sob NDA)](/pt-BR/home/setup-install/dev-kit-settings/config-dev-kit-settings)<br />[Configurando áreas restritas para o desenvolvimento do XBOX Live](/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes)<br />[XSystemGetConsoleId](/pt-BR/reference/system/xsystem/functions/xsystemgetconsoleid)<br />[XSystem](/pt-BR/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemGetXboxLiveSandboxId](/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)
- [Advanced XBOX services sandboxes](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [XSystem](/reference/system/xsystem/xsystem_members.md)
- [Determining console location](/build/game-principles/localization/determining-console-geolocation.md)
- [콘솔 위치 확인](/ko/build/game-principles/localization/determining-console-geolocation.md)