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

# game_chat_communication_relationship_adjuster_changed_state_change

> game_chat_communication_relationship_adjuster_changed_state_change

# game\_chat\_communication\_relationship\_adjuster\_changed\_state\_change

Representa informações específicas da alteração de estado [game\_chat\_state\_change\_type::communication\_relationship\_adjuster\_changed](/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type).

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
typedef struct game_chat_communication_relationship_adjuster_changed_state_change {  
    chat_user* local_user;  
    chat_user* target_user;  
} game_chat_communication_relationship_adjuster_changed_state_change  
```

<a id="membersSection" />

### Membros

*local\_user*  \
Tipo: [chat\_user](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Um ponteiro para o objeto `chat_user` que representa o usuário local no qual o relacionamento se baseia.

Os ponteiros para objetos `chat_user` permanecem válidos até que o usuário seja removido da instância local de [chat\_manager](/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager) por meio do método [chat\_manager::remove\_user](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user).

*target\_user*  \
Tipo: [chat\_user](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Um ponteiro para o objeto `chat_user` que representa o usuário de destino no relacionamento. Esse usuário pode ser local ou remoto.

<a id="remarksSection" />

## Comentários

Essa estrutura fornece informações adicionais para uma alteração de estado [game\_chat\_state\_change\_type::text\_chat\_received](/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type) no Game Chat 2. Essa alteração de estado ocorre quando o ajustador de relacionamento de comunicação de um usuário local em relação a outro usuário é alterado. Essa alteração de estado pode ocorrer nas seguintes condições:

* Um relacionamento de comunicação entre um par específico de usuários foi definido pela primeira vez; espera-se que o ajustador passe para o estado `initializing`.
* O ajustador terminou a inicialização.
* O ajustador foi alterado devido a uma ação do usuário; por exemplo, um relacionamento de privacidade foi alterado.

Para determinar o relacionamento de comunicação efetivo e o ajustador aplicado, chame o método [chat\_user\_local::get\_effective\_communication\_relationship](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_get_effective_communication_relationship), conforme ilustrado no exemplo de código a seguir.

```cpp theme={null}
game_chat_communication_relationship_flags effectiveRelationship;
game_chat_communication_relationship_adjuster adjuster; 
local_user->get_effective_communication_relationship(target_user, &effectiveRelationship, &adjuster);
```

Se essa alteração de estado ocorrer, essa estrutura será retornada como um elemento [game\_chat\_state\_change](/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change) na matriz [game\_chat\_state\_change\_array](/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change#array) recuperada quando [chat\_manager::start\_processing\_state\_changes](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes) for chamado pelo seu aplicativo. Depois de confirmar o tipo de alteração de estado verificando o valor do membro `state_change_type` desse elemento `game_chat_state_change`, você poderá converter esse elemento nessa estrutura. Em seguida, você poderá usar essa estrutura para obter mais informações sobre a alteração de estado e processá-la antes que a matriz seja devolvida ao Game Chat 2 pelo seu aplicativo, chamando [chat\_manager::finish\_processing\_state\_changes](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

Para obter mais informações sobre o processamento de alterações de estado, confira [Usando a API C++ do Game Chat 2](/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** GameChat2.h

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

<a id="seealsoSection" />

## Confira também

[Introdução ao Game Chat 2](/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_user\_local::set\_communication\_relationship](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_communication_relationship)\
[game\_chat\_communication\_relationship\_adjuster](/pt-BR/reference/chat/gamechat2/enums/game_chat_communication_relationship_adjuster)\
[Membros do GameChat2](/pt-BR/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_communication_relationship_adjuster_changed_state_change](/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [game_chat_state_change](/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 members](/reference/chat/gamechat2/gamechat2_members.md)