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

# XblMultiplayerSessionHostCandidates

> XblMultiplayerSessionHostCandidates

# XblMultiplayerSessionHostCandidates

Os candidatos a host são uma lista de tokens de dispositivo, ordenada por preferência conforme especificado por XblMultiplayerMetrics nas constantes da sessão.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerSessionHostCandidates(  
         XblMultiplayerSessionHandle handle,  
         const XblDeviceToken** deviceTokens,  
         size_t* deviceTokensCount  
)  
```

### Parâmetros

*handle*   \_In\_\
Tipo: [XblMultiplayerSessionHandle](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle.md)

Identificador da sessão multijogador.

*deviceTokens*   \_Out\_\
Tipo: [XblDeviceToken\*\*](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken.md)

Retorna um ponteiro para a matriz de tokens de dispositivo candidatos. A memória do ponteiro permanecerá válida durante a vida útil do objeto XblMultiplayerSessionHandle, até que ele seja fechado.

*deviceTokensCount*   \_Out\_\
Tipo: size\_t\*

Retorna o tamanho da matriz deviceTokens.

### Valor retornado

Tipo: HRESULT

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

## Requisitos

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

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

## Confira também

[multiplayer\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)


## Related topics

- [Tarefas de multijogador](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSessionSetServerConnectionStringCandidates](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetserverconnectionstringcandidates.md)
- [XblMultiplayerManagerLobbySessionHost](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionhost.md)
- [XblMultiplayerManagerLobbySessionIsHost](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)
- [XblMultiplayerManagerGameSessionHost](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionhost.md)