> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# add_local_user

> chat_manager::add_local_user

# chat\_manager::add\_local\_user

로컬 chat\_manager 인스턴스에 로컬 사용자를 추가합니다.

## 구문

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

### 매개 변수

*xboxUserId*   \_In\_\
형식: PCWSTR

추가할 로컬 사용자의 XBOX User ID입니다.

### 반환 값

형식: chat\_user\*

## 설명

Game Chat 2 인스턴스에 추가되는 모든 로컬 사용자는 먼저 [XUserAddAsync](https://docs.xbox.com/ko/reference/system/xuser/functions/xuseraddasync.md)로 추가해야 합니다.

로컬 및 원격 사용자의 총 수가 chat\_manager::initialize()에 지정된 최대 사용자 수와 같지 않는 한 사용자가 무조건 추가됩니다.

반환 값은 이 사용자와 연결된 chat\_user 개체에 대한 포인터입니다. XBOX User ID가 잘못된 경우 사용자의 chat\_indicator 값은 game\_chat\_user\_chat\_indicator::platform\_restricted가 됩니다.

일반적인 패턴은 다음과 같습니다.

```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); 
} 
```

## 요구 사항

**헤더:** GameChat2.h

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 관련 항목

[chat\_manager](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)\
[chat\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md)\
[chat\_manager::add\_remote\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)\
[chat\_manager::remove\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md)


## Related topics

- [chat_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md)
- [get_chat_users](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_chat_users.md)
- [Multiplayer Manager API 개요](https://docs.xbox.com/ko/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblSocialManagerAddLocalUser](https://docs.xbox.com/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser.md)
- [XblAchievementsManagerAddLocalUser](https://docs.xbox.com/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanageraddlocaluser.md)