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

Recupera a coleção de usuários locais e remotos que foram adicionados à instância de chat.

## Sintaxe

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

### Parâmetros

*chatUserCount*   \_Out\_\
Tipo: uint32\_t\*

O número total de usuários locais e remotos que foram adicionados à instância de chat.

*chatUsers*   \_Outptr\_result\_buffer\_(\*chatUserCount)\
Tipo: [chat\_user\_array](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user.md)\*

Uma matriz de ponteiros [chat\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user.md) que representa os usuários locais e remotos que foram adicionados à instância de chat.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Este método recupera a coleção de usuários locais e remotos que foram adicionados à instância de chat, retornando o número total de usuários em `chatUserCount` e uma matriz de ponteiros [chat\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user.md), cada um representando um usuário local ou remoto, em `chatUsers`. O ponteiro da matriz retornado em `chatUsers` é válido até a próxima chamada a qualquer um dos seguintes métodos:

* [chat\_manager::add\_local\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
* [chat\_manager::add\_remote\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
* [chat\_manager::cleanup](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup.md)
* [chat\_manager::remove\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md)

Os objetos `chat_user` individuais permanecem válidos até que o usuário seja removido por uma chamada a `chat_manager::remove_user`. Para obter mais informações sobre como inicializar e limpar uma instância de chat, confira [Usando a API C++ do Game Chat 2](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md).

## Requisitos

**Cabeçalho:** GameChat2.h

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

## Confira também

[Introdução ao Game Chat 2](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[chat\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user.md)\
[chat\_manager](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)


## Related topics

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