Skip to main content

XSystemGetXboxLiveSandboxId

Recupera a ID da área restrita do XBOX Live.

Sintaxe

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 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. 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.
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

Confira também

Definindo as configurações do kit de desenvolvimento (tópico sob NDA)
Configurando áreas restritas para o desenvolvimento do XBOX Live
XSystemGetConsoleId
XSystem
Last modified on October 6, 2026