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

Adiciona um usuário remoto à instância local de chat\_manager.

## Sintaxe

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

### Parâmetros

*xboxUserId*   \_In\_\
Tipo: PCWSTR

A ID de usuário do XBOX do usuário remoto a ser adicionado.

*locallyUniqueEndpointIdentifier*   \_In\_\
Tipo: uint64\_t

Um identificador gerado pelo título usado para se referir ao ponto de extremidade em que o usuário remoto está. Um ponto de extremidade é um dispositivo, como um XBOX One ou um PC. Cada ponto de extremidade deve ter um identificador exclusivo na instância local do Game Chat; o identificador não precisa ser globalmente exclusivo na rede. Usuários remotos no mesmo ponto de extremidade, como dois usuários jogando no mesmo XBOX One, devem ser adicionados com o mesmo identificador de ponto de extremidade. O Game Chat usará esse identificador para indicar, na estrutura game\_chat\_data\_frame, para quais pontos de extremidade os dados devem ser enviados, e ele deve ser usado pelo título para indicar, em chat\_manager::process\_incoming\_data(), de qual ponto de extremidade os dados vieram.

### Valor retornado

Tipo: chat\_user\*

## Comentários

O usuário será adicionado incondicionalmente, a menos que o número total de usuários locais e remotos seja igual à contagem máxima de usuários indicada em chat\_manager::initialize(). <br /><br /> O valor retornado é um ponteiro para o objeto chat\_user associado a esse usuário. Se a ID de usuário do XBOX for inválida, o valor de chat\_indicator do usuário será game\_chat\_user\_chat\_indicator::platform\_restricted.

## Requisitos

**Cabeçalho:** GameChat2.h

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

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


## Related topics

- [chat_manager::add_remote_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
- [chat_manager::add_local_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)