Skip to main content

XUserFindUserById

基于本地用户的 XBOX 用户 ID (XUID) 检索 XUserHandle。

语法

参数

userId   _In_
类型:uint64_t
要检索 XUID 的本地用户。 handle   _Out_
类型:XUserHandle*
包含本地用户的 XUID。

返回值

类型:HRESULT HRESULT 成功或错误代码。
有关错误代码列表,请参阅错误代码

注解

在时间敏感线程上调用此函数并不安全。有关详细信息,请参阅时间敏感线程
对于从 XUser API(包括 XUserFindUserById)检索到的每个 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日