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

Envía una solicitud de emparejamiento al servidor.

## Sintaxis

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

### Parámetros

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

El nombre del hopper para esta solicitud.

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

Opcional. Los atributos del ticket de partida para esta solicitud, como una cadena JSON.

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

El tiempo máximo, en segundos, que se debe esperar a que los usuarios se unan a la partida.

### Valor devuelto

Tipo: HRESULT

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

## Comentarios

Esta función envía una solicitud de emparejamiento para la sesión de sala a Multiplayer Manager (MPM). Antes de poder usar esta función, primero debe configurar los hoppers en la configuración del servicio de su título. Un hopper define las reglas que SmartMatch usa para emparejar a los jugadores. Para obtener más información sobre los hoppers, consulte [Información general del emparejamiento](/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview). Si no existe una sesión de sala, probablemente porque no se llamó a [XblMultiplayerManagerInitialize](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize), o si no se agregaron usuarios locales a la sesión de sala antes de llamar a esta función, se produce un error. También se produce un error si el emparejamiento ya está en curso. <br />El resultado de esta función se entrega como un evento multijugador con un tipo de evento establecido en `XblMultiplayerEventType::FindMatchCompleted`. Puede llamar a [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) para recuperar los eventos multijugador.

## Requisitos

**Encabezado:** multiplayer\_manager\_c.h

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

## Consulte también

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


## Related topics

- [XblMultiplayerManagerCancelMatch](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [Emparejamiento multijugador con SmartMatch y MPM](/es/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Información general sobre la API de Multiplayer Manager](/es/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerEventType](/es/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)