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

> chat_manager::add_local_user

# chat\_manager::add\_local\_user

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

## Syntaxe

```cpp theme={null}
chat_user* add_local_user(  
    PCWSTR xboxUserId  
)  
```

### Paramètres

*xboxUserId*   \_In\_\
Type : PCWSTR

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

### Valeur de retour

Type : chat\_user\*

## Remarques

Tous les utilisateurs locaux ajoutés à l'instance de Game Chat 2 doivent d'abord être ajoutés avec [XUserAddAsync](/fr-CA/reference/system/xuser/functions/xuseraddasync).

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().

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.

Voici un modèle typique :

```cpp theme={null}
chat_user* newLocalChatUser = chat_manager::singleton_instance().add_local_user(<local_user_xuid>);

size_t chatUserCount; 
chat_user_array chatUsers; 
chat_manager::singleton_instance().get_remote_chat_users(&chatUserCount, &chatUsers); 
for (uint32_t chatUserIndex = 0; chatUserIndex < chatUsercount; ++chatUserIndex) 
{ 
    chat_user* chatUser = chatUsers[chatUserIndex]; 
    game_chat_communication_relationship_flags relationship = game_chat_communication_relationship_flags::none; 
    if (chatUser can send and receive to/from newLocalChatUser) 
    { 
        relationship = c_communicationRelationshipSendAndReceiveAll; 
    } 
    else if (chatUser can send to newLocalChatUser) 
    { 
        relationship = c_communicationRelationshipSendAll; 
    } 
    else if (chatUser can receive from newLocalChatUser) 
    { 
        relationship = c_communicationRelationshipReceiveAll; 
    } 

    newLocalChatUser->set_communication_relationship(chatUser, relationship); 
} 
```

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


## Related topics

- [chat_manager::get_chat_users](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_chat_users.md)
- [Utilisation de l'API C++ de Game Chat 2](/fr-CA/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [chat_manager::add_remote_user](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
- [chat_manager::remove_user](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md)
- [chat_user::local](/fr-CA/reference/chat/gamechat2/classes/chat_user/methods/chat_user_local_function_2.md)