> ## 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.

# chat_manager::add_remote_user

> chat_manager::add_remote_user

# chat\_manager::add\_remote\_user

向本地 chat\_manager 实例添加远程用户。

## 语法

```cpp theme={null}
chat_user* add_remote_user(  
    PCWSTR xboxUserId,  
    uint64_t locallyUniqueEndpointIdentifier  
)  
```

### 参数

*xboxUserId*   \_In\_\
类型：PCWSTR

要添加的远程用户的 XBOX 用户 ID。

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

由标题生成的标识符，用于指代远程用户所在的终结点。终结点是设备（例如 XBOX One 或 PC）。在本地 Game Chat 实例中，每个终结点必须具有唯一的标识符；此标识符不需要在整个网络中全局唯一。位于同一终结点上的远程用户（例如在同一 XBOX One 上玩游戏的两个用户）必须使用相同的终结点标识符添加。Game Chat 将使用此标识符在 game\_chat\_data\_frame 结构中指示必须将数据发送到哪个终结点，标题必须在 chat\_manager::process\_incoming\_data() 中使用它来指示数据来自哪个终结点。

### 返回值

类型：chat\_user\*

## 备注

除非本地用户和远程用户的总数已达到 chat\_manager::initialize() 中指定的最大用户数，否则将无条件添加该用户。<br /><br /> 返回值是与此用户关联的 chat\_user 对象的指针。如果 XBOX 用户 ID 无效，则该用户的 chat\_indicator 值将为 game\_chat\_user\_chat\_indicator::platform\_restricted。

## 要求

**头文件：** GameChat2.h

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

## 另请参阅

[chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_user](/reference/chat/gamechat2/classes/chat_user/chat_user)\
[chat\_manager::add\_remote\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user)\
[chat\_manager::remove\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user)\
[chat\_manager::process\_incoming\_data](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data)\
[game\_chat\_data\_frame](/reference/chat/gamechat2/structs/game_chat_data_frame)


## Related topics

- [chat_manager::add_local_user](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
- [chat_manager::remove_user](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md)
- [chat_manager::get_chat_users](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_chat_users.md)
- [chat_manager::process_incoming_data](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [game_chat_data_frame](/zh-CN/reference/chat/gamechat2/structs/game_chat_data_frame.md)