다음을 통해 공유

XSystemGetAppSpecificDeviceId

  • 아티클

콘솔에서 호출자의 타이틀과 관련된 고유 값을 반환합니다.

구문

HRESULT XSystemGetAppSpecificDeviceId(  
         size_t appSpecificDeviceIdSize,  
         char* appSpecificDeviceId,  
         size_t* appSpecificDeviceIdUsed  
)

매개 변수

appSpecificDeviceIdSize _In_
형식: size_t

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

appSpecificDeviceId _Out_writes_bytes_to_(appSpecificDeviceIdSize, *appSpecificDeviceIdUsed)
형식: char*

응용 프로그램 특정 장치 ID를 수신할 문자 버퍼입니다.

appSpecificDeviceIdUsed _Out_opt_
형식: size_t*

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

반환 값

형식: HRESULT

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

비고

참고 항목

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

오류로 인해 응용 프로그램 특정 장치 ID를 얻을 수 없는 경우 상수 문자열 "00000000000000000000000000000000000000000000"이 반환됩니다.

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

요구 사항

헤더: XSystem.h

라이브러리: xgameruntime.lib

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

참고 항목

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