> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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\*](/services/playfab/multiplayer/networking/reference/typedefs)
*大小为 `*chatControlCount` 的库分配的输出数组*

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

### 返回值

PartyError

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

## 备注

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

## 要求

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

## 另请参阅

[PartyDevice](/services/playfab/multiplayer/networking/reference/classes/PartyDevice/partydevice)
[PartyLocalDevice::CreateChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)
[PartyLocalDevice::DestroyChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_destroychatcontrol)
[PartyChatControlDestroyedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange)


## Related topics

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