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

Ajoute un utilisateur distant à l'instance chat\_manager locale.

## Syntaxe

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

### Paramètres

*xboxUserId*   \_In\_\
Type : PCWSTR

L'ID d'utilisateur XBOX de l'utilisateur distant à ajouter.

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

Identificateur généré par le titre, utilisé pour désigner le point de terminaison sur lequel se trouve l'utilisateur distant. Un point de terminaison est un appareil, comme une XBOX One ou un PC. Chaque point de terminaison doit avoir un identificateur unique dans l'instance locale de Game Chat; l'identificateur n'a pas besoin d'être unique à l'échelle du réseau. Les utilisateurs distants sur le même point de terminaison, comme deux utilisateurs jouant sur la même XBOX One, doivent être ajoutés avec le même identificateur de point de terminaison. Game Chat utilisera cet identificateur pour indiquer, dans la structure game\_chat\_data\_frame, à quels points de terminaison les données doivent être envoyées, et le titre doit l'utiliser pour indiquer de quel point de terminaison proviennent les données dans chat\_manager::process\_incoming\_data().

### Valeur de retour

Type : chat\_user\*

## Remarques

L'utilisateur est ajouté sans condition, sauf si le nombre total d'utilisateurs locaux et distants est égal au nombre maximal d'utilisateurs indiqué dans chat\_manager::initialize(). <br /><br /> La valeur de retour est un pointeur vers l'objet chat\_user associé à cet utilisateur. Si l'ID d'utilisateur XBOX n'est pas valide, la valeur chat\_indicator de l'utilisateur sera game\_chat\_user\_chat\_indicator::platform\_restricted.

## Configuration requise

**En-tête :** GameChat2.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[chat\_manager](/fr-CA/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_user](/fr-CA/reference/chat/gamechat2/classes/chat_user/chat_user)\
[chat\_manager::add\_remote\_user](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user)\
[chat\_manager::remove\_user](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user)\
[chat\_manager::process\_incoming\_data](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data)\
[game\_chat\_data\_frame](/fr-CA/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)