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

# XblMultiplayerManagerFindMatch

> XblMultiplayerManagerFindMatch

# XblMultiplayerManagerFindMatch

Soumet une demande de matchmaking au serveur.

## Syntaxe

```cpp theme={null}
HRESULT XblMultiplayerManagerFindMatch(  
         const char* hopperName,  
         const char* attributesJson,  
         uint32_t timeoutInSeconds  
)  
```

### Paramètres

*hopperName*   \_In\_z\_\
Type : char\*

Nom de la trémie (hopper) pour cette demande.

*attributesJson*   \_In\_opt\_z\_\
Type : char\*

Facultatif. Attributs du ticket de match pour cette demande, sous forme de chaîne JSON.

*timeoutInSeconds*   \_In\_\
Type : uint32\_t

Durée maximale, en secondes, d'attente que les utilisateurs rejoignent le match.

### Valeur de retour

Type : HRESULT

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

## Remarques

Cette fonction soumet une demande de matchmaking pour la session de salle d'attente à Multiplayer Manager (MPM). Avant de pouvoir utiliser cette fonction, vous devez d'abord configurer des trémies dans la configuration de service de votre titre. Une trémie définit les règles utilisées par SmartMatch pour associer les joueurs. Pour plus d'informations sur les trémies, consultez [Vue d'ensemble du matchmaking](/fr/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview). Si aucune session de salle d'attente n'existe, probablement parce que [XblMultiplayerManagerInitialize](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize) n'a pas été appelée, ou si les utilisateurs locaux n'ont pas été ajoutés à la session de salle d'attente avant l'appel de cette fonction, une erreur se produit. Une erreur se produit également si un matchmaking est déjà en cours. <br />Le résultat de cette fonction est fourni sous la forme d'un événement multijoueur dont le type d'événement est défini sur `XblMultiplayerEventType::FindMatchCompleted`. Vous pouvez appeler [XblMultiplayerManagerDoWork](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) pour récupérer les événements multijoueurs.

## Configuration requise

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

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

## Voir aussi

[multiplayer\_manager\_c](/fr/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerEstimatedMatchWaitTime](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime)


## Related topics

- [XblMultiplayerManagerFindMatch](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerfindmatch.md)
- [XblMultiplayerManagerCancelMatch](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [Multiplayer matchmaking with SmartMatch and MPM](/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Emparejamiento multijugador con SmartMatch y MPM](/es/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)