XGameGetXboxTitleId
返回游戏的 TitleID。
语法
HRESULT XGameGetXboxTitleId(
uint32_t* titleId
)
参数
titleId _Out_
类型：uint32_t*
指向游戏的 TitleID 的指针。
返回值
类型：HRESULT
如果成功，则返回 S_OK；否则返回错误代码。 有关错误代码的列表，请参阅错误代码。 如果 TitleID 不是由游戏开发者在 MicrosoftGame.config 文件中配置的，则返回值将设置为 HRESULT_FROM_WIN32(ERROR_NOT_FOUND)。
备注
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。
TitleID 用于向 Xbox Live 服务唯一地标识您的游戏。 该 ID 用于整个 Xbox Live 服务中，使您的用户可以访问您游戏的实时内容（例如用户统计数据和成就）并支持实时多人游戏功能。 TitleID 存储在游戏的 MicrosoftGame.config 清单文件中。
下面的示例将生成一个 URL，用于调用游戏使用的后端 REST 服务。 调用 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 主机