Skip to main content

XUserGetLocalId

ユーザーの一意なゲーム セッション ID を取得します。

構文

パラメーター

user   _In_
Type: XUserHandle
ローカル ID を取得する対象のユーザーへのハンドルです。 userLocalId   _Out_
Type: XUserLocalId*
ユーザーの一意なゲーム セッション ID が格納されます。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。
エラー コードの一覧については、エラー コード を参照してください。

解説

特定のユーザーのユーザー ID を取得するには、XUserGetId を呼び出します。 特定のユーザーの状態を取得するには、XUserGetState を呼び出します。 特定のユーザーの年齢グループを取得するには、XUserGetAgeGroup を呼び出します。 XUserLocalId は、ゲーム セッション内でユーザーを一意に識別します。XUserHandle を複製した場合、両方のハンドルは同じ XUserLocalId を保持します。ゲーム セッションが終了すると、同じユーザーであっても次のセッションでは異なる XUserLocalId が付与される可能性があります。これらの ID を、ゲーム セッションをまたいでユーザーを追跡する目的で使用しないでください。 以下の例は、XUserLocalId を使用してユーザーの既定のオーディオ エンドポイントを取得する方法を示しています。

要件

ヘッダー: XUser.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、Steam Deck、XBOX One ファミリ本体および XBOX Series 本体

関連項目

XUser XUserGetId XUserGetState XUserGetAgeGroup
最終更新日 2026年8月24日