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

# PartyDevice::GetChatControls

> 获取此设备上的聊天控件。

获取此设备上的聊天控件。

## 语法

```cpp theme={null}
PartyError GetChatControls(  
    uint32_t* chatControlCount,  
    PartyChatControlArray* chatControls  
)  
```

### 参数

**`chatControlCount`**   uint32\_t\*
*输出*

此设备上聊天控件的输出数量。

**`chatControls`**   [PartyChatControlArray\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/typedefs.md)
*大小为 `*chatControlCount` 的库分配的输出数组*

一个由库分配的输出数组,包含此设备上的聊天控件。

### 返回值

PartyError

如果调用成功,则返回 `c_partyErrorSuccess`;否则返回错误代码。可以通过 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 检索错误代码的人类可读形式。

## 备注

一旦 [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) 提供了 [PartyChatControlDestroyedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md),该聊天控件将不再出现在此方法返回的数组中。\
\
 每当标题调用 PartyManager::StartProcessingStateChanges() 时,返回数组的内存都会失效。如果这是本地设备,则当 [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md) 返回成功时,该数组的内存也会失效。

## 要求

\*\*头文件:\*\*Party.h

## 另请参阅

[PartyDevice](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyDevice/partydevice.md)
[PartyLocalDevice::CreateChatControl](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)
[PartyLocalDevice::DestroyChatControl](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_destroychatcontrol.md)
[PartyChatControlDestroyedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md)


## Related topics

- [PartyLocalDevice::CreateChatControl](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)
- [PartyManager::GetChatControls](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)
- [PartyChatControl::GetDevice](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/methods/partychatcontrol_getdevice.md)
- [PartyNetwork::GetChatControls](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_getchatcontrols.md)
- [PartyDevice::GetLocal](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getlocal.md)