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

# get_chat_users

> chat_manager::get_chat_users

# chat\_manager::get\_chat\_users

채팅 인스턴스에 추가된 로컬 및 원격 사용자 컬렉션을 검색합니다.

## 구문

```cpp theme={null}
void get_chat_users(  
    uint32_t* chatUserCount,  
    chat_user_array* chatUsers  
)  
```

### 매개 변수

*chatUserCount*   \_Out\_\
형식: uint32\_t\*

채팅 인스턴스에 추가된 로컬 및 원격 사용자의 총 수입니다.

*chatUsers*   \_Outptr\_result\_buffer\_(\*chatUserCount)\
형식: [chat\_user\_array](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md)\*

채팅 인스턴스에 추가된 로컬 및 원격 사용자를 나타내는 [chat\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md) 포인터의 배열입니다.

### 반환 값

형식: void

없음.

## 설명

이 메서드는 채팅 인스턴스에 추가된 로컬 및 원격 사용자의 컬렉션을 검색하여 `chatUserCount`에 총 사용자 수를 반환하고 `chatUsers`에 로컬 또는 원격 사용자를 각각 나타내는 [chat\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md) 포인터의 배열을 반환합니다. `chatUsers`에 반환된 배열 포인터는 다음 메서드 중 하나에 대한 다음 호출까지 유효합니다.

* [chat\_manager::add\_local\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_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::cleanup](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup.md)
* [chat\_manager::remove\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md)

개별 `chat_user` 개체는 `chat_manager::remove_user` 호출로 사용자가 제거될 때까지 유효한 상태로 유지됩니다. 채팅 인스턴스 초기화 및 정리에 대한 자세한 내용은 [Game Chat 2 C++ API 사용](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)을 참조하세요.

## 요구 사항

**헤더:** GameChat2.h

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

## 관련 항목

[Game Chat 2 소개](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[chat\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md)\
[chat\_manager](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)


## Related topics

- [chat_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md)
- [PartyXblManager::GetChatUsers](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getchatusers.md)
- [PartyXblManager](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)
- [PartyXblChatUser::GetXboxUserId](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/xblreference/classes/PartyXblChatUser/methods/partyxblchatuser_getxboxuserid.md)
- [PartyXblChatUser::GetLocal](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/xblreference/classes/PartyXblChatUser/methods/partyxblchatuser_getlocal.md)