XUserFindUserByLocalId
检索特定本地用户 ID 的用户句柄。
语法
HRESULT XUserFindUserByLocalId(
XUserLocalId userLocalId,
XUserHandle* handle
)
参数
userLocalId _In_
类型：XUserLocalId
要获取其用户的本地 ID。
handle _Out_
类型：XUserHandle*
包含与特定本地用户 ID 关联的用户句柄。
返回值
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。
类型：HRESULT
HRESULT 成功或错误代码。
| 返回代码 | 说明 |
|---|---|
| S_OK | 操作成功。 |
| HRESULT_FROM_WIN32(ERROR_NOT_FOUND) | 未找到用户。 |
备注
对于从 XUser API 检索到的每个 XUserHandle 句柄（包括 XUserFindUserByLocalId），您必须关闭调用 XUserCloseHandle 的那个句柄。 调用 Get / Find 函数后，句柄的引用计数将增加。
要检索特定的本地用户 ID 的用户句柄，请调用 XUserFindUserByLocalId。
要检索本地用户的 XBox 用户 ID (XUID)，请调用 XUserFindUserById。
要检索特定设备 ID 的用户 ID，请调用 XUserFindForDevice。
要求
头文件：XUser.h
库：xgameruntime.lib
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机