다음을 통해 공유


XSystemGetXboxLiveSandboxId

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

구문

HRESULT XSystemGetXboxLiveSandboxId(  
         size_t sandboxIdSize,  
         char* sandboxId,  
         size_t* sandboxIdUsed  
)  

매개 변수

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를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요. sandboxIdSizeXSystemXboxLiveSandboxIdMaxBytes보다 작은 값으로 설정되어 함수가 실패하는 경우 반환 값은 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