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

# XUserGetId

> XUserGetId

# XUserGetId

获取特定用户的用户 ID。

## 语法

```cpp theme={null}
HRESULT XUserGetId(  
         XUserHandle user,  
         uint64_t* userId  
)  
```

### 参数

*user*   \_In\_\
类型：XUserHandle

要检索用户 ID 的用户的句柄。

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

包含特定用户的用户 ID。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

| 返回代码                                        | 说明                                                                                                                            |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| S\_OK                                       | 操作成功。                                                                                                                         |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 用户必须使用 UI 来解决该问题。调用 [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync) 以向用户显示 UI。 |

## 注解

检索用户的 XUID。如果函数返回 **E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED**，用户需要使用系统 UI 解决问题，之后函数才能检索该属性。调用 [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync) 以显示系统 UI 并解决该问题。

## 要求

**头文件：** XUser.h

**库：** xgameruntime.lib

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

## 概念文档

* [使用 Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## 另请参阅

[XUser](/reference/system/xuser/xuser_members)

[XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid)

[XUserFindUserByLocalId](/reference/system/xuser/functions/xuserfinduserbylocalid)


## Related topics

- [XUserGetLocalId](/zh-CN/reference/system/xuser/functions/xusergetlocalid.md)
- [XUserGetMaxUsers](/zh-CN/reference/system/xuser/functions/xusergetmaxusers.md)
- [XUserGetGamertag](/zh-CN/reference/system/xuser/functions/xusergetgamertag.md)
- [用户身份与 XUser](/zh-CN/build/core-features/common/user/player-identity-xuser.md)
- [PC 上的 XStore — DRM、许可证令牌和沙盒](/zh-CN/publishing/xstore-commerce/xstore-pc.md)