Skip to main content

​
XUserFindForDevice

特定のデバイス ID に対応するユーザー ID を取得します。

​
構文

​
パラメーター

deviceId   _In_
Type: APP_LOCAL_DEVICE_ID* デバイスの ID です。
handle   _Out_
Type: XUserHandle* ローカル ユーザーの XUID が格納されます。

​
戻り値

Type: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。 エラー コードの一覧については、エラー コード を参照してください。

​
解説

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、時間依存スレッド を参照してください。
ユーザーとデバイスの関連付けは、以下のようなさまざまな理由で変化する場合があります。
  • ユーザーが本体からサインアウトする。
  • 入力デバイスを使用してアカウント ピッカーで別のユーザーが選択される。
ユーザーとデバイスの関連付けが変化したときに通知を受け取るには、XUserRegisterForDeviceAssociationChanged を呼び出して XUserDeviceAssociationChangedCallback を取得します。
XUserFindForDevice は、XUserAddAsync の呼び出しでサインインしていないユーザーのユーザー ハンドルを返せません。詳細については、ユーザーと入力デバイス を参照してください。

​
要件

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

​
概念ドキュメント

​
関連項目

XUser XUserRegisterForDeviceAssociationChanged XUserDeviceAssociationChangedCallback
最終更新日 2026年8月24日

関連トピック

XUserFindUserByIdXUserFindUserByLocalIdAPP_LOCAL_DEVICE_IDXUserユーザーと入力デバイス