Skip to main content

XSystemGetXboxLiveSandboxId

XBOX Live 샌드박스 ID를 검색합니다.

구문

매개 변수

sandboxIdSize _In_
형식: size_t
_sandboxId_의 크기(바이트)입니다. 이 값은 XSystem.h에 정의된 XSystemXboxLiveSandboxIdMaxBytes 상수보다 크거나 같아야 합니다. sandboxId _Out_writes_bytes_to_(sandboxIdSize,*sandboxIdUsed)
형식: char*
샌드박스 ID를 받을 문자 버퍼입니다. sandboxIdUsed _Out_opt_
형식: size_t*
반환되는 sandboxId 버퍼의 실제 크기(바이트)입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요. _sandboxIdSize_가 XSystemXboxLiveSandboxIdMaxBytes보다 작은 값으로 설정되어 함수가 실패하는 경우, 반환 값은 **HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)**로 설정됩니다.

설명

TitleID 및 SCID(서비스 구성 ID)와 함께 샌드박스 ID는 XBOX Live 타이틀 및 애플리케이션의 개발에 매우 중요합니다. 샌드박스 ID는 사용자의 샌드박스를 식별하며, 개발 중에 개발 키트에 대해 콘텐츠 격리를 제공합니다. 콘텐츠 격리를 통해 타이틀을 개발하고 테스트할 수 있는 깨끗한 환경이 보장됩니다.
샌드박스 ID는 대/소문자를 구분합니다.
XBOX 및 PC 디바이스의 경우 샌드박스 ID가 디바이스에 저장되어 있습니다. 샌드박스 ID를 찾을 수 없거나 샌드박스 ID에 액세스할 권한이 없는 경우 샌드박스 ID는 기본적으로 ‘RETAIL’로 지정됩니다. 실제로 게임이 소매 환경에서 실행 중인 경우에도 이 함수는 ‘RETAIL’을 반환합니다.

요구 사항

헤더: XSystem.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

개발 키트 설정 구성(NDA 주제)
XBOX Live 개발용 샌드박스 설정
XSystemGetConsoleId
XSystem
마지막 수정일 2026년 8월 24일