XSystemGetConsoleId
현재 디바이스의 콘솔 ID를 반환합니다.구문
매개 변수
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)**로 설정됩니다.설명
이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
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 토큰의 pairwise ID를 사용해야 합니다.
- 그렇지 않으면 XSystemGetAppSpecificDeviceId 함수를 사용하세요.
요구 사항
헤더: XSystem.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
개발 키트 활성화(NDA 주제)XSystemGetXboxLiveSandbodId
XSystem