> ## 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 User 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 User 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](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
- [chat_manager::remove_user](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md)
- [chat_manager::get_chat_users](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_chat_users.md)
- [chat_manager::process_incoming_data](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [game_chat_data_frame](/ko/reference/chat/gamechat2/structs/game_chat_data_frame.md)