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

# XblMultiplayerManagerGameSessionSetSynchronizedHost

> XblMultiplayerManagerGameSessionSetSynchronizedHost

# XblMultiplayerManagerGameSessionSetSynchronizedHost

Define o host da sessão de jogo usando `XblMultiplayerSessionWriteMode::SynchronizedUpdate`.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerManagerGameSessionSetSynchronizedHost(  
         const char* deviceToken,  
         void* context  
)  
```

### Parâmetros

*deviceToken*   \_In\_\
Tipo: char\*

O token de dispositivo do host.

*context*   \_In\_opt\_\
Tipo: void\*

Opcional. Os dados definidos pelo aplicativo para correlacionar o [XblMultiplayerEvent](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) à chamada inicial.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT desta operação de API.

## Comentários

Esta função define o host da sessão de jogo. Use esta função para garantir a atomicidade e resolver quaisquer conflitos entre dispositivos que tentam definir o host ao mesmo tempo. <br />O serviço pode rejeitar a solicitação para definir o host se ocorrer uma condição de corrida devido a um conflito. Se a solicitação for rejeitada, o serviço retornará `HTTP_E_STATUS_PRECOND_FAILED`. Se ocorrer um conflito, reavalie a necessidade de alterar o host e, se necessário, chame esta função novamente para reenviar a solicitação.  <br />O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::SynchronizedHostWriteCompleted`. Você pode chamar [XblMultiplayerManagerDoWork](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) para recuperar eventos multijogador.  Observe que os tokens de dispositivo do host são gerados a partir do endereço de dispositivo seguro de um membro da sessão; portanto, verifique se o endereço de dispositivo seguro está definido para o host desejado antes de chamar este método.

## Requisitos

**Cabeçalho:** multiplayer\_manager\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[multiplayer\_manager\_c](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerGameSessionSetSynchronizedProperties](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties)\
[XblMultiplayerEvent](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)\
[XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetlocalmemberconnectionaddress)


## Related topics

- [XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)