PartyDevice::GetChatControls

Gets the chat controls on this device.

Syntax

PartyError GetChatControls(  
    uint32_t* chatControlCount,  
    PartyChatControlArray* chatControls  
)  

Parameters

chatControlCount   uint32_t*
output

The output number of chat controls on this device.

chatControls   PartyChatControlArray*
library-allocated output array of size *chatControlCount

A library-allocated output array containing the chat controls on this device.

Return value

PartyError

c_partyErrorSuccess if the call succeeded or an error code otherwise. The human-readable form of the error code can be retrieved via PartyManager::GetErrorMessage().

Remarks

Once a PartyChatControlDestroyedStateChange has been provided by PartyManager::StartProcessingStateChanges(), the chat control will no longer be present in the array returned by this method.

The memory for the returned array is invalidated whenever the title calls PartyManager::StartProcessingStateChanges(). If this is the local device, the memory for the array is also invalidated when PartyLocalDevice::CreateChatControl() returns success.

Requirements

Header: Party.h

See also

PartyDevice
PartyLocalDevice::CreateChatControl
PartyLocalDevice::DestroyChatControl
PartyChatControlDestroyedStateChange