> ## 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/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md)\*

[chat\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md) 指標的陣列，代表已新增至聊天執行個體的本機和遠端使用者。

### 傳回值

類型：void

無。

## 備註

此方法會擷取已新增至聊天執行個體的本機和遠端使用者集合，在 `chatUserCount` 中傳回使用者總數，並在 `chatUsers` 中傳回 [chat\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md) 指標的陣列，其中每個指標都代表一個本機或遠端使用者。`chatUsers` 中傳回的陣列指標在下次呼叫下列任一方法之前都有效：

* [chat\_manager::add\_local\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
* [chat\_manager::add\_remote\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
* [chat\_manager::cleanup](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup.md)
* [chat\_manager::remove\_user](https://docs.xbox.com/zh-TW/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/zh-TW/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/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[chat\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md)\
[chat\_manager](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)


## Related topics

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