> ## 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 使用者識別碼。

*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 使用者識別碼無效，使用者的 chat\_indicator 值將會是 game\_chat\_user\_chat\_indicator::platform\_restricted。

## 需求

**標頭：** GameChat2.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

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