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

Envia uma solicitação de matchmaking ao servidor.

## Sintaxe

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

### Parâmetros

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

O nome do hopper desta solicitação.

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

Opcional. Os atributos do tíquete de partida desta solicitação, como uma cadeia de caracteres JSON.

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

O tempo máximo, em segundos, de espera para que os usuários ingressem na partida.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Esta função envia uma solicitação de matchmaking da sessão de lobby ao Multiplayer Manager (MPM). Antes de usar esta função, você deve primeiro configurar hoppers na configuração de serviço do seu título. Um hopper define as regras que o SmartMatch usa para combinar jogadores. Para obter mais informações sobre hoppers, consulte [Visão geral do matchmaking](/pt-BR/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview). Se não existir uma sessão de lobby, provavelmente porque [XblMultiplayerManagerInitialize](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize) não foi chamada, ou se os usuários locais não tiverem sido adicionados à sessão de lobby antes de chamar esta função, ocorrerá um erro. Também ocorrerá um erro se o matchmaking já estiver em andamento. <br />O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::FindMatchCompleted`. Você pode chamar [XblMultiplayerManagerDoWork](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) para recuperar eventos multijogador.

## Requisitos

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

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

## Confira também

[multiplayer\_manager\_c](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerEstimatedMatchWaitTime](/pt-BR/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)