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 サービスに対してゲームを一意に識別するためのものです。 TitleID は、ユーザー統計情報や実績などのゲームの Live コンテンツにユーザーがアクセスするために、また、Live のマルチプレイヤー機能を有効にするために、 Xbox Live サービス全体を通して使用されます。 TitleID は、ゲームの MicrosoftGame.config マニフェスト ファイルに保存されます。
次の例では、ゲームで使用されるバックエンド REST サービスを呼び出すための URL を生成します。 XGameGetXBoxTitleId 関数は、URL の一部として TitleID を含めるために呼び出されます。
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 本体