> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\_\
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)\
Tipo: char\*

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

*sandboxIdUsed*   \_Out\_opt\_\
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](https://docs.xbox.com/pt-BR/reference/errorcodes.md). 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.

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)](https://docs.xbox.com/pt-BR/home/setup-install/dev-kit-settings/config-dev-kit-settings.md)\
[Configurando áreas restritas para o desenvolvimento do XBOX Live](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)\
[XSystemGetConsoleId](https://docs.xbox.com/pt-BR/reference/system/xsystem/functions/xsystemgetconsoleid.md)\
[XSystem](https://docs.xbox.com/pt-BR/reference/system/xsystem/xsystem_members.md)


## Related topics

- [Áreas restritas avançadas dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [Determinação da localização do console](https://docs.xbox.com/pt-BR/build/game-principles/localization/determining-console-geolocation.md)
- [XSystem (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xsystem/xsystem_members.md)
- [Get Title Players From Xbox Live IDs](https://docs.xbox.com/api-reference/account-management/get-title-players-from-xbox-live-ids.md)
- [PFAccountManagementGetPlayFabIDsFromXboxLiveIDsRequest](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementgetplayfabidsfromxboxliveidsrequest.md)