XUserFindForDevice
特定のデバイス ID に対するユーザー ID を取得します。
構文
HRESULT XUserFindForDevice(
const APP_LOCAL_DEVICE_ID* deviceId,
XUserHandle* handle
)
パラメーター
deviceId _In_
型: APP_LOCAL_DEVICE_ID*
デバイスの ID。
handle _Out_
型: XUserHandle*
ローカル ユーザーの XUID が格納されます。
戻り値
型: HRESULT
正常に実行された場合は S_OK が返され、それ以外の場合はエラー コードが返されます。 エラー コードの一覧については、「エラー コード」を参照してください。
解説
注意
この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。
ユーザーとデバイスの関連付けは、さまざまな理由で変更される可能性があります。
- ユーザーが本体からサインアウトする。
- 誰かが入力デバイスを使用して、アカウント選択で別のユーザーを選択する。
ユーザーとデバイスの関連付けが変化したときに通知を受け取るには、 XUserRegisterForDeviceAssociationChanged を呼び出して XUserDeviceAssociationChangedCallback を取得します。
注意
XUserFindForDevice は、XUserAddAsync の呼び出しでサインインしていないユーザーにユーザー ハンドルを返せません。 詳細については、「ユーザーと入力デバイス」を参照してください。
要件
ヘッダー: XUser.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体