Skip to main content

XUserFindUserById

ローカル ユーザーの XBOX ユーザー ID (XUID) に基づいて XUserHandle を取得します。

構文

パラメーター

userId   _In_
Type: uint64_t
XUID を取得する対象のローカル ユーザーです。 handle   _Out_
Type: XUserHandle*
ローカル ユーザーの XUID が格納されます。

戻り値

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

解説

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、時間依存スレッド を参照してください。
XUserFindUserById を含む XUser API から取得した XUserHandle ハンドルは、いずれも XUserCloseHandle を呼び出して閉じる必要があります。 ローカル ユーザーの XBOX ユーザー ID (XUID) を取得するには、XUserFindUserById を呼び出します。 特定のローカル ユーザー ID に対応するユーザーへのハンドルを取得するには、XUserFindUserByLocalId を呼び出します。 特定のデバイス ID に対応するユーザー ID を取得するには、XUserFindForDevice を呼び出します。

要件

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

概念ドキュメント

関連項目

XUser XUserFindUserByLocalId XUserFindForDevice
最終更新日 2026年8月24日