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

# XblMultiplayerSessionHostCandidates

> XblMultiplayerSessionHostCandidates

# XblMultiplayerSessionHostCandidates

Los candidatos a host son una lista ordenada de tokens de dispositivo, ordenados por preferencia según lo especificado por XblMultiplayerMetrics en las constantes de la sesión.

## Sintaxis

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

### Parámetros

*handle*   \_In\_\
Tipo: [XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

Identificador de la sesión multijugador.

*deviceTokens*   \_Out\_\
Tipo: [XblDeviceToken\*\*](/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

Devuelve un puntero a la matriz de tokens de dispositivo candidatos. La memoria del puntero seguirá siendo válida durante la vigencia del objeto XblMultiplayerSessionHandle hasta que se cierre.

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

Devuelve el tamaño de la matriz deviceTokens.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT de esta operación de API.

## Requisitos

**Encabezado:** multiplayer\_c.h

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

## Consulte también

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [Tareas multijugador](/es/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSessionSetServerConnectionStringCandidates](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetserverconnectionstringcandidates.md)
- [XblMultiplayerManagerGameSessionHost](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionhost.md)
- [XblMultiplayerManagerGameSessionIsHost](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionishost.md)
- [XblMultiplayerManagerLobbySessionHost](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionhost.md)