XGameGetXboxTitleId
게임의 TitleID를 반환합니다.
구문
HRESULT XGameGetXboxTitleId(
uint32_t* titleId
)
매개 변수
titleId _Out_
형식: uint32_t*
게임의 TitleID에 대한 포인터입니다.
반환 값
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요. MicrosoftGame.config 파일에 게임 개발자가 TitleID를 구성하지 않은 경우 반환 값은 HRESULT_FROM_WIN32(ERROR_NOT_FOUND)로 설정됩니다.
비고
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
TitleID는 Xbox Live 서비스에서 게임을 고유하게 식별합니다. 이 ID는 Xbox Live 서비스 전반에 걸쳐 사용자가 사용자 통계 및 도전 과제와 같이 게임의 라이브 콘텐츠에 액세스하고 라이브 멀티 플레이어 기능을 사용할 수 있도록 합니다. TitleID는 게임의 MicrosoftGame.config 매니페스트 파일에 저장됩니다.
다음 예제에서는 게임에서 사용되는 백엔드 REST 서비스를 호출하기 위한 URL을 생성합니다. XGameGetXBoxTitleId 함수는 TitleID를 URL의 일부로 포함하기 위해 호출됩니다.
std::string GetBackendServiceUrl()
{
uint32_t titleId;
RetailAssert(SUCCEEDED(XGameGetXboxTitleId(&titleId)));
std::stringstream url;
url << "https://example.com/some/api/call";
url << std::hex << std::uppercase << std::setfill('0');
url << "/titleId/" << std::setw(8) << titleId;
return url.str();
}
요구 사항
헤더: XGame.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔