Skip to main content

XUserFindForDevice

检索特定设备 ID 对应的用户 ID。

语法

参数

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

概念文档

另请参阅

XUser XUserRegisterForDeviceAssociationChanged XUserDeviceAssociationChangedCallback
最后修改于 2026年8月24日