다음을 통해 공유

XSystemGetConsoleId

  • 아티클

현재 장치의 콘솔 ID를 반환합니다.

구문

HRESULT XSystemGetConsoleId(  
         size_t consoleIdSize,  
         char* consoleId,  
         size_t* consoleIdUsed  
)

매개 변수

consoleIdSize _In_
형식: size_t

consoleId의 크기(바이트)입니다. 이 값은 XSystem.h에 정의된 XSystemConsoleIdBytes 상수보다 크거나 같아야 합니다.

consoleId _Out_writes_bytes_to_(consoleIdSize,*consoleIdUsed)
형식: char*

콘솔 ID를 수신할 문자 버퍼입니다.

consoleIdUsed _Out_opt_
형식: size_t*

반환된 consoleId 버퍼의 크기(바이트)입니다.

반환 값

형식: HRESULT

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

비고

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

콘솔 ID는 개발용 시나리오에 대해서만 Xbox Live 용 Xbox 장치를 고유하게 식별합니다. 콘솔 ID는 로깅 및 관리 목적으로 콘솔을 식별하는 데 사용됩니다. 예를 들어 분석 정보를 캡처하거나 개발 환경에서 재부팅할 개발 키트를 결정합니다. 이 함수에서 반환된 ID는 설정\시스템\콘솔 정보에서 볼 수 있는 콘솔 ID와 일치합니다.

Xbox 장치의 경우 콘솔 ID가 장치에 저장됩니다. 콘솔 ID를 찾을 수 없거나 콘솔 ID에 액세스할 수 있는 권한이 없는 경우 콘솔 ID는 기본값이 00000000.00000000.00000000.00000000.00로 설정됩니다. PC 장치의 경우 콘솔 ID는 항상 기본값 00000000.00000000.00000000.00000000.00(으)로 설정됩니다.

RETAIL에서 이 함수는 항상 00000000.00000000.00000000.00000000.00을(를) 반환합니다. 게임에 소매를 비롯한 모든 상황에서 사용할 수 있는 식별자가 필요한 경우에는 다음 두 가지 상황이 있습니다.

  • 애플리케이션에서 SSO(Single Sign-On)를 사용하는 경우 이 함수에서 반환되는 ID 대신 XSTS SSO 토큰의 쌍으로 ID를 설정해야 합니다.
  • 아니면 XSystemGetAppSpecificDeviceId 함수를 사용합니다.

요구 사항

헤더: XSystem.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

개발 키트 활성화(NDA 항목)
XSystemGetXboxLiveSandbodId
XSystem