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

# 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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md) à 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. \
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.  \
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::SynchronizedHostWriteCompleted`. Você pode chamar [XblMultiplayerManagerDoWork](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerGameSessionSetSynchronizedProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)\
[XblMultiplayerEvent](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md)\
[XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetlocalmemberconnectionaddress.md)


## Related topics

- [XblMultiplayerManagerGameSessionSetSynchronizedProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)
- [XblMultiplayerManagerGameSessionIsHost](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionishost.md)
- [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md)
- [XblMultiplayerManagerLobbySessionSetLocalMemberProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetlocalmemberproperties.md)
- [Visão geral da API do Multiplayer Manager](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)