> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserFindUserById

> XUserFindUserById

# XUserFindUserById

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

## 语法

```cpp theme={null}
HRESULT XUserFindUserById(  
         uint64_t userId,  
         XUserHandle* handle  
)  
```

### 参数

*userId*   \_In\_\
类型：uint64\_t

要检索 XUID 的本地用户。

*handle*   \_Out\_\
类型：XUserHandle\*

包含本地用户的 XUID。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。\
有关错误代码列表，请参阅[错误代码](https://docs.xbox.com/zh-CN/reference/errorcodes.md)。

## 注解

> [!NOTE]
>
> 在时间敏感线程上调用此函数并不安全。有关详细信息，请参阅[时间敏感线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。

对于从 **XUser** API（包括 **XUserFindUserById**）检索到的每个 **XUserHandle** 句柄，必须通过调用 [XUserCloseHandle](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserclosehandle.md) 关闭该句柄。

若要检索本地用户的 XBOX 用户 ID (XUID)，请调用 XUserFindUserById。

若要检索特定本地用户 ID 对应的用户句柄，请调用 [XUserFindUserByLocalId](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfinduserbylocalid.md)。

若要检索特定设备 ID 对应的用户 ID，请调用 [XUserFindForDevice](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfindfordevice.md)。

## 要求

**头文件：** XUser.h

**库：** xgameruntime.lib

**支持的平台：** Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [时间敏感线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [使用 Game Chat 2 C++ API](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)

## 另请参阅

[XUser](https://docs.xbox.com/zh-CN/reference/system/xuser/xuser_members.md)

[XUserFindUserByLocalId](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfinduserbylocalid.md)

[XUserFindForDevice](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfindfordevice.md)


## Related topics

- [XUserFindUserByLocalId](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfinduserbylocalid.md)
- [XUserGetId](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergetid.md)
- [使用 Game Chat 2 C++ API](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [XUser（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xuser/xuser_members.md)
- [在 Unity 项目中使用 GDK API 的 C# 包装器](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)