XUserFindUserById

根据本地用户的 Xbox 用户 ID(XUID)检索 XUserHandle。

语法

HRESULT XUserFindUserById(  
         uint64_t userId,  
         XUserHandle* handle  
)  

参数

userId _In_
类型:uint64_t

要检索其 XUID 的本地用户。

handle _Out_
类型:XUserHandle*

包含本地用户的 XUID。

返回值

类型:HRESULT

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

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息,请参阅时间敏感线程

对于从 XUser API 检索到的每个 XUserHandle 句柄(包括 XUserFindUserById),您必须关闭调用 XUserCloseHandle 的那个句柄。

要检索本地用户的 XBox 用户 ID (XUID),请调用 XUserFindUserById。

若要检索特定本地用户 ID 的用户句柄,请调用 XUserFindUserByLocalId

要检索特定设备 ID 的用户 ID,请调用 XUserFindForDevice

要求

头文件:XUser.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XUser

XUserFindUserByLocalId

XUserFindForDevice