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

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

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

Facultatif. Les attributs du ticket de correspondance pour cette demande, sous forme de chaîne JSON.

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

Le délai maximal, en secondes, pendant lequel attendre que les utilisateurs rejoignent la correspondance.

### 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 salon à Multiplayer Manager (MPM). Avant de pouvoir utiliser cette fonction, vous devez d'abord configurer des trémies (hoppers) dans la configuration de service de votre titre. Une trémie définit les règles que SmartMatch utilise pour mettre les joueurs en correspondance. Pour plus d'informations sur les trémies, consultez [Vue d'ensemble du matchmaking](/fr-CA/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview). Si aucune session de salon n'existe, probablement parce que [XblMultiplayerManagerInitialize](/fr-CA/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 salon 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 forme d'événement multijoueur dont le type d'événement est défini sur `XblMultiplayerEventType::FindMatchCompleted`. Vous pouvez appeler [XblMultiplayerManagerDoWork](/fr-CA/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-CA/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerEstimatedMatchWaitTime](/fr-CA/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)