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

Les candidats hôtes sont une liste de jetons d'appareil, triée par ordre de préférence selon les XblMultiplayerMetrics spécifiées dans les constantes de session.

## Syntaxe

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

### Paramètres

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

Handle de la session multijoueur.

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

Retourne un pointeur vers le tableau des jetons d'appareil candidats. La mémoire du pointeur reste valide pendant toute la durée de vie de l'objet XblMultiplayerSessionHandle, jusqu'à sa fermeture.

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

Retourne la taille du tableau deviceTokens.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

## Configuration requise

**En-tête :** multiplayer\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

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


## Related topics

- [Tâches multijoueurs](/fr/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSessionSetServerConnectionStringCandidates](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetserverconnectionstringcandidates.md)
- [XblMultiplayerManagerGameSessionHost](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionhost.md)
- [XblMultiplayerManagerGameSessionIsHost](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionishost.md)
- [XblMultiplayerManagerLobbySessionHost](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionhost.md)