Skip to main content

​
XSystemGetAppSpecificDeviceId

호출자의 타이틀 ID에 특정한 콘솔의 고유 값을 반환합니다.

​
구문

​
매개 변수

appSpecificDeviceIdSize   _In_
형식: size_t appSpecificDeviceId의 크기(바이트)입니다. 이 값은 XSystem.h에 정의된 XSystemAppSpecificDeviceIdBytes 상수보다 크거나 같아야 합니다. appSpecificDeviceId   _Out_writes_bytes_to_(appSpecificDeviceIdSize, *appSpecificDeviceIdUsed)
형식: char* 애플리케이션 특정 디바이스 ID를 받을 문자 버퍼입니다. appSpecificDeviceIdUsed   _Out_opt_
형식: size_t* 반환되는 appSpecificDeviceIdUsed 버퍼의 크기(바이트)입니다.

​
반환 값

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

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 다음을 참조하세요.
시간에 민감한 스레드. 오류로 인해 애플리케이션 특정 디바이스 식별자를 가져올 수 없는 경우 상수 문자열 “00000000000000000000000000000000000000000000”이 반환됩니다. 애플리케이션이 SSO(Single-Sign-On)를 사용하는 경우 이 함수가 반환하는 ID 대신 XSTS SSO 토큰의 pairwise ID를 사용해야 합니다.

​
요구 사항

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

​
함께 보기

개발 키트 활성화(NDA 주제)
XSystemGetXboxLiveSandbodId
XSystem
마지막 수정일 2026년 8월 24일

관련 항목

XSystemXSystemGetConsoleIdGDK용 Unity C# API 래퍼APP_LOCAL_DEVICE_IDILampArray::GetDeviceId