Skip to main content

​
XUserFindUserByLocalId

检索特定本地用户 ID 对应的用户句柄。

​
语法

​
参数

userLocalId   _In_
类型：XUserLocalId 要获取用户的本地 ID。 handle   _Out_
类型：XUserHandle* 包含与特定本地用户 ID 关联的用户句柄。

​
返回值

在时间敏感线程上调用此函数并不安全。有关详细信息，请参阅时间敏感线程。
类型：HRESULT HRESULT 成功或错误代码。

​
注解

对于从 XUser API（包括 XUserFindUserByLocalId）检索到的每个 XUserHandle 句柄，必须通过调用 XUserCloseHandle 关闭该句柄。调用 Get / Find 函数后，句柄的引用计数会增加。 若要检索特定本地用户 ID 对应的用户句柄，请调用 XUserFindUserByLocalId。 若要检索本地用户的 XBOX 用户 ID (XUID)，请调用 XUserFindUserById。 若要检索特定设备 ID 对应的用户 ID，请调用 XUserFindForDevice。

​
要求

头文件： XUser.h 库： xgameruntime.lib 支持的平台： Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

​
概念文档

​
另请参阅

XUser XUserFindUserById XUserFindForDevice
最后修改于 2026年8月24日

相关主题

XUserFindUserByIdXUserLocalIdXUserGetIdXUser面向 GDK 的 Unity C# API 包装器