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 主机